home *** CD-ROM | disk | FTP | other *** search
/ Chip 1997 January / CHIP Turkiye Ocak 1997.iso / program / sound / mp061 / document / midplay.eng < prev    next >
Text File  |  1996-10-12  |  16KB  |  438 lines
  1. $Version: NONE $
  2. $Revision: 1.5 $
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                           M i D P L A Y       V 0.61
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                    CopyLeft 1996 SounDWorX. A few rights reserved.
  19.  
  20.  
  21.                                Code and Graphix:
  22.                                -----------------
  23.  
  24.                                 Till Toenshoff
  25.  
  26.  
  27.  
  28. Features:
  29. ---------
  30.  
  31. - Plays through SoundBlaster AWE, Roland MPU401 and SoundBlaster MIDI-
  32.   interface
  33. - Supports all midi-file-format-levels
  34. - Supports MUS-files
  35. - Supports SoundBlaster AWE soundbank-files (SBK's or SF2's !!!)
  36. - Help [F-1]
  37. - VESA (1.x or 2.0) SVGA-resolution (640x480x256, 800x600x256, 1024x768x256)
  38. - X-mode VGA-resolution (360x400x256)
  39. - Autodetect output-devices and I/O-ports
  40. - Autoload SBK-files (AWE only, you may have guessed that ;) )
  41. - Sends ALL midi-data -> supports XG-midi etc...
  42. - Special effects (AWE only)
  43. - Music Playback Settings loader -> see SAMPLE.MPS for details (AWE only)
  44. - Supports channel mapping -> Synthie, AWE and Waveblaster together !
  45. - Configuration Profile -> see MP.INI for details
  46.  
  47.  
  48. Requirements:
  49. -------------
  50.  
  51.         - 80386 or better processor
  52.         - VGA graphics card
  53.         - more than 2MB free memory
  54.     - more than 2MB free disk-space
  55.         - a SoundBlaster AWE and/or
  56.           a SoundBlaster-compatible MIDI-interface and/or
  57.           a Roland MPU401-compatible interface (or software-emulator)
  58.         - works under DOS >= 5.0 and Windows'95 (not NT)
  59.  
  60.  
  61.  
  62. Introduction:
  63. -------------
  64.  
  65. Why another Midi-Player ?
  66.  
  67. MiDPLAY was written because I wanted to have a fancy looking player that
  68. fully supports my SoundBlaster AWE. I found it terrible annoying to load
  69. SBKs with this Windows'95 Control Panel and then load the MIDI-file
  70. with the Mediaplayer just to listen to a song.
  71. Next reason for the creation of MiDPLAY was to have a program that supports
  72. playback via a MIDI-interface (so I could use both, my AWE and my Synthie
  73. for playback under DOS).
  74.  
  75. Technical Information
  76.  
  77. MiDPLAY is allmost completely written in C (Watcom). The only toolkit or
  78. library MiDPLAY uses are the ADIP 3.01 (the AWE-specific hardware access) by
  79. Creative Labs (get it FREE from their ftp-server) and the JPEG-Library 6.0 of
  80. the Independent JPEG Group (also free on the net).
  81. Most problems come from the ADIP...
  82. For the graphics I used Photoshop, Deluxe Paint, Truespace and some homegrown
  83. tools.
  84.  
  85. Some Explanations.... (for newbies only !)
  86.  
  87. MIDI    - A standard in music-buisness that makes it possible to connect
  88.           (electronic)instruments from diffrent manufacturers.
  89.           MIDI is not just the cable, but also a collection of commands.
  90.           There is a command for a start of a note (NOTE ON), one
  91.           for changing the pitch of a note (PITCH) and many more...
  92.           MIDI-files are songs that can directly be replayed by any MIDI
  93.           instrument (using a player or sequencer).
  94. GM      - General Midi - A standard that describes the instruments.
  95. GS      - General Standard - Another standard that describes instruments and
  96.           sound-effects
  97. XG      - eXtendet General Midi - Yet another standard in instrument and
  98.           sound-effect controlling. Yamaha has produced a board for the
  99.           SB-waveblaster-expansion that follows this standard.
  100. EMU8000 - the chip on the SoundBlaster AWE Card that produces the nice
  101.           sound when music is played (not WAV-samples but MIDI-songs).
  102.           Connected to this chip is a 1 Megabyte ROM that contains the
  103.           preset (GM) instruments.
  104. SBK     - SoundFont 1 files are instrument collections especially for the
  105.           EMU8000.
  106. SF2     - SoundFont 2 files are instrument collections especially for the
  107.           EMU8000. SF2 is a new standard by EMU.
  108.  
  109.  
  110. Playing music file(s):
  111. ----------------------
  112.  
  113.         Play a single file:
  114.         Example:        MP IPANEMA.MID
  115.  
  116.         Play multiple files using wildcards:
  117.         Example:        MP HERBER?.MID
  118.                         MP S*.M*
  119.  
  120.         Play a single file with a SoundBank loaded into userbank 1:
  121.         Example:        MP LYNNPNO.SBK AWETELLT.MID
  122.  
  123.         Play a single file with a SoundBank automatically loaded (in bank 1):
  124.         Example:        MP AWERELEN.MID -A
  125.  
  126.         Play a single file with a Synthesizer-SoundBank loaded (in bank 20):
  127.         Example:        MP SYNTHGS.SBK FOO.MID -A20
  128.  
  129.         Play multiple files using a list file:
  130.         Example:        MP @COOLMIDS.LST
  131.         Where the text file COOLMIDS.LST may look like this:
  132.                         F:\MUS\PETBERT.MUS
  133.                         G:\SOUNDCD\SOUND\MID\YOMON.MID
  134.                         F:\MID\MARYJANE.MPS
  135.                         G:\SOUNDCD\SOUND\MID\SHAMEN.MPS
  136.  
  137.         Play a file with a SoundFont 2 SoundBank loaded into userbank 1:
  138.         Example:        MP SYNTHGM.SF2 FOO.SF2 BAR.MID -A0,1
  139.         NOTE:           If you play songs in "SoundFont 2"- mode you first
  140.                         need to load a synthesizer SoundBank such as
  141.                         SYNTHGM.SF2 (into userbank 0)
  142.  
  143.  
  144. Advanced Commandline Options:
  145. -----------------------------
  146.  
  147.         -l                      loop playlist
  148.         Example:                MP HOGAN.MID -l
  149.  
  150.         -a(:NUMBER(,NUMBER))    (automatically) load SoundBank into any
  151.                                 bank (0-63)
  152.         Example:                MP TZONE.MID -a:20
  153.         NOTE:                   It is recommended that synthesizer SoundBanks
  154.                                 such as SYNTHGM.SBK or SYNTHGM.SF2 are loaded
  155.                                 into userbank 0 !
  156.  
  157.  
  158.         -f:EFFECT(,EFFECT)      chorus- and reverb-settings
  159.                                 (may be overwritten by songfile SysEx-Data !)
  160.  
  161.            EFFECTS:     REVERB                CHORUS
  162.            ------------------------------------------------
  163.                         Room1                 Chorus1
  164.                         Room2                 Chorus2
  165.                         Room3                 Chorus3
  166.                         Hall1                 Chorus4
  167.                         Hall2                 FeedbackDelay
  168.                         Plate                 Flanger
  169.                         Delay                 ShortDelay
  170.                         PanningDelay          ShortDelayFB
  171.            ------------------------------------------------
  172.  
  173.         Example:        MP DAS_BOOT.MID -f:HALL1,FLANGER
  174.  
  175.         -t:THEME        load basic preset settings (see MP.INI for details !)
  176.         Example:        MP SFX.MID -tGS
  177.  
  178.  
  179. Control-keys during playback:
  180. -----------------------------
  181.  
  182.         ESC                     Return to DOS
  183.         F1                      Help page
  184.         Page Down               Switch output-device on all channels
  185.         1 thru 0 and A thru F   Switch output-device on channel 1 thru 16
  186.         Shift &   "      "      Mute Channel 1 thru 16
  187.         Space                   Pause [Hit again to continue playing]
  188.         Cursor Right            Skip forward
  189.         Cursor Left             Skip backward
  190.         Cursor Down             Next song
  191.         Cursor Up               Previous song
  192.         P                       Panic!
  193.         L                       Loop songs
  194.         S                       DOS Shell (type 'EXIT' to return to MiDPLAY)
  195.         R                       Restore Start-Up Settings
  196.  
  197.  
  198. Error-Messages and their reasons:
  199. ---------------------------------
  200.  
  201.         - "file not found"
  202.           You made a mistake when giving the song-filename in the commandline !
  203.  
  204.         - "file corrupted"
  205.           The file has been damaged - check your hard-drive !
  206.  
  207.         - "can't open file"
  208.           File is locked - is there another program accessing this file ?
  209.  
  210.         - "filetype not supported"
  211.           MiDPLAY can't handle this file !
  212.  
  213.         - "not enough memory"
  214.           You need more memory !
  215.  
  216.         - "no MIDI-OUT-DEVICE present"
  217.           MiDPLAY did not find a single output-device !
  218.  
  219.         - "can't initialize sound-device"
  220.           The output-device does not work as expected - is it installed
  221.           properly ?
  222.  
  223.         - "no standard midi file"
  224.           This is not a real MIDI file or it has been corrupted.
  225.  
  226.         - "no standard mus file"
  227.           This is not a real MUS file or it has been corrupted.
  228.  
  229.     - "no standard sbk file"
  230.           This is not a real SoundFont 1 file or it has been corrupted.
  231.  
  232.         - "no standard sf2 file"
  233.           This is not a real SoundFont 2 file or it has been corrupted.
  234.  
  235.         - "not a MIDI, MUS, MPS, SBK or SF2 file"
  236.           MiDPLAY can only handle those files !
  237.  
  238.         - "failed to init graphix"
  239.           A problem occured when initializing the VGA-code - do you use
  240.           a standard VGA card ?
  241.  
  242.         - "no VESA graphics BIOS/driver found"
  243.           Did not find a VESA compatible svga-card - install a VESA-
  244.           Graphics-Driver ! (e.g. UNIVBE)
  245.  
  246.         - "not enough memory on soundcard"
  247.           This SoundFont-file is too big.
  248.  
  249.         - "failed to process MPS-file"
  250.           This is most likely not a "Music Playback Settings" file !
  251.  
  252.         - "failed to process parameters"
  253.           You made a syntax error in any command-parameters - (commandline
  254.           and/or MPS-file) !
  255.  
  256.         - "error in MP.INI"
  257.           Something went wrong in your MP.INI - try to fix it or install it
  258.           again.
  259.  
  260.         - "no such theme in MP.INI"
  261.           You specified a theme to load (-t) but MiDPLAY can't find that one
  262.           in your MP.INI.
  263.  
  264.     - "cant load SF2/s when SBK/s allready loaded"
  265.           You can't load both types together. You have to load SoundFont 1
  266.           files OR SoundFont 2 files. NOT BOTH TOGETHER !!!
  267.  
  268.     - "cant load SBK/s when SF2/s allready loaded"
  269.           You can't load both types together. You have to load SoundFont 1
  270.           files OR SoundFont 2 files. NOT BOTH TOGETHER !!!
  271.  
  272.         - "internal error"
  273.           Ooopsi !
  274.           -> please contact the author about what you did to get this error !
  275.  
  276.  
  277. Troubleshooting
  278. ---------------
  279.  
  280.       * The player doesn't find any output-devices:
  281.         You should have installed your Soundcard properly !!!
  282.         If you want to use a SoundBlaster-compatible-midi-interface,
  283.         make sure that the BLASTER-string is set.
  284.         If you want to use a SoundBlaster AWE, make sure that
  285.         CTSB16.SYS and CTMMSYS.SYS are loaded and active.
  286.  
  287.       * Screen is screwed or doesn't synchronize or is just black:
  288.         X-Mode
  289.         Your VGA-card and/or your display-device does not support the 400x600-
  290.         resolution. Add -x0 to your command-line to use the 360x400-mode.
  291.         If this does not work you are probably using a LCD-display that does
  292.         not support X-Mode-VGA-Graphix.
  293.         VESA
  294.         Your SVGA-card or your display-device is not installed correctly.
  295.         Check the refresh-rates for the VESA-Modes (101h,...)
  296.         in your SVGA-card installation-tools.
  297.  
  298.       * Songs sound strange or seem to have the wrong instruments:
  299.         AWE
  300.         Is there a SoundFont belonging to the song you tried to play ?
  301.         Try to load the SoundFont and the song manually.
  302.         If you want to load a SoundFont 2 (.SF2) into a bank number other
  303.         than 0, you also have to load the GM instrument-presets
  304.         (SYNTHGM.SF2) into bank number 0.
  305.         All
  306.         This song may not match any MIDI-standard. It can not properly be
  307.         replayed with your MIDI-equipment.
  308.         If you tried it with another player and you are sure that only
  309.         MiDPLAY fails to replay it correctly, please mail it to me !!!
  310.  
  311.  
  312. Known Bugs:
  313. -----------
  314.  
  315. - only one type of soundbanks is supported at runtime -> you can either
  316.   load SBKs or SF2s but NOT BOTH.
  317. - wastes memory like if it was a Windows-App ;) - WHO CARES !!!
  318. - the AWE DIP 2.52 introduces a new bug; in MIDI-SBK-combis with RAM-drums
  319.   on channel 10, ROM-drums wont be played anymore on channel 10 ??
  320.  
  321.  
  322. Future:
  323. -------
  324.  
  325. Scopes          - I would really like to have scopes in my player...  we'll see
  326. Cakewalk files  - playing .WRK-files under DOS would be another nice feature
  327.                   is there any info on these files out there ????
  328. Mixer           - many users asked for a build-in awe-mixer -> there will
  329.                   be one in 0.8 or 0.9
  330. Filemanager     - many users asked for a build-in file-manager -> there will
  331.                   be one in 0.7
  332. GUS patches     - loading GUS patches instead of SoundFont might be a nice
  333.                   feature
  334.  
  335.  
  336. Getting Updates:
  337. ----------------
  338.  
  339. The newest version will allways be located in my web-page (see below).
  340. Fido-users will get the newest version at 2:2437/301 (Digital Nightmare).
  341.  
  342. You may also write an E-Mail (address below):
  343. SUBJECT-FIELD:    mp by email
  344. MESSAGE-BODY:    your@email.address
  345. If you do so, you will allways get the newest version of MiDPLAY as soon
  346. as its out. It will be stored in a uu-encoded ZIP-archive (one packet,
  347. about 2MB !).
  348.  
  349.  
  350. Contacting The Author:
  351. ----------------------
  352.  
  353. WWW:            http://www.rz.uni-hildesheim.de/~ttoe0057
  354.  
  355. E-Mail:         ttoe0057@rz.uni-hildesheim.de (NeXTmail wellcome !)
  356.  
  357. Fido:           2:2437/301.0 (Till Toenshoff)
  358.  
  359. Snail-Mail:     Till Toenshoff
  360.                 Augustastrasse 22
  361.                 31141 Hildesheim
  362.                 GERMANY
  363.  
  364.  
  365. Before You Write a Mail to the Author:
  366. --------------------------------------
  367.  
  368. READ THIS MANUAL ! (Troubleshooting, etc...)
  369.  
  370.  
  371. Disclaimer:
  372. -----------
  373.  
  374. In no event the author will be liable for any damages, including any
  375. lost profits, lost savings or other incidental or consequential damages
  376. arising out of your use or inability to use the program, or for any claim
  377. by any other party.
  378.  
  379. This version of MiDPLAY is free, it may not be sold or bundled without written
  380. permission of the author. Also, it may not be used in a commercial way without
  381. permission.
  382.  
  383. It is not allowed distribute MiDPLAY on any Freeware-/Public Domain/Shareware
  384. Compilation (CDROM,etc..) unless you send at least 1 sample of that CD to the
  385. authors adress !
  386.  
  387. If you like this player, PLeAzE SpReAD iT !
  388.  
  389. If you are a Shareware-Author, send a registered copy of your program to the
  390. authors adress.
  391.  
  392. If you want to make me happy and be a REGISTERED USER of MiDPLAY, write an email
  393. or a postcard. Thats just to see how far this player got.
  394.  
  395. I would also like to get some feedback about the things you miss in my player...
  396.  
  397. I'm looking for some GM-Midi-Files and SBK/SF2-Midi-Files that I may bundle
  398. with my player. If you are a composer, and you don't mind if YOUR OWN songs
  399. are bundled with MiDPLAY -> please mail them. (! non commercial only !)
  400.  
  401.  
  402. Credits:
  403. --------
  404.  
  405. The internal JPEG decompression and quantization is based in part on the work of
  406. the Independent JPEG Group.
  407.  
  408. The SoundBlaster AWE 32 low level device access is based on the AWE Developers
  409. Information Pack done by Creative Labs.
  410.  
  411.  
  412. Respect:
  413. --------
  414.  
  415. Keith Ohlfs/NeXT, Rob Hubbard, Bart Crane/Media Vision, Steven Jobs,
  416. Kai Krause, Chris Roberts, all GNU-people
  417.  
  418.  
  419. Greetings:
  420. ----------
  421.  
  422. Excessive Tools, Cubic Team, DLUSiON, Brian/Legend Design
  423.  
  424.  
  425. THANX:
  426. ------
  427.  
  428. MoM for ANSI-art !
  429. Tom, Jense and Holgi for testing
  430. Speedy for the MPU401 infos
  431. Lukas for spreading (finally did it ;) ) -> see ftp.cdrom.com !
  432.       and for leeching the ADIP from this ULTRA-SLOW-CL-SERVER
  433.  
  434.  
  435.  
  436. c u,
  437. Till Toenshoff
  438.